pp108 : Editing the Message Map Data of a Process Instance

Editing the Message Map Data of a Process Instance

This topic describes the procedure to edit the Message Map data of a process instance from the Process Instance Manager (PIM).

Before you begin this task:
You must have the Process Administrator role in Process Platform Business Process Engine application package to view the Message Map of a process instance.

You can edit the message map of a process instance if it is in one of the following statuses:

  • Suspend: Process instance that is suspended. Activities in a process instance cannot be executed till the process instance is resumed.
  • Aborted: Process instance that is aborted. A process instance can be aborted due to some error, for example, failure to invoke a Web service.
  • Waiting: Process instance that is waiting for a response from a manual activity or an incoming message.
  • Debug Ready: Process instance that has reached a breakpoint which was defined for the busines process model during design time. It can be continued through the Process Debugger or it can be resumed.
  1. Do one of the following to view the Message Mapof a process instance and edit it:

    To view from...window

    Procedure

    Process Instance Manager (PIM)


    1.In My Applications palette, click (Process Instance Manager). The Process Instance Manager appears displaying a list of business processes that have process instances.
    2.Click Find () on the toolbar. The Filter Process Instances window appears. If you do not specify the filter criteria for process instances, the default filter options are considered.
    3.Type the selection criteria.
    4.Click OK. All process instances that match the specified criteria appear.
    5.Click the instances with the status for which you want to view the process instance details. The Instances by Process Definition window appears.

    Sub-Processes


    1.In My Applications palette, click (Process Instance Manager). The Process Instance Manager appears displaying a list of business processes that have process instances.
    2.Click Find () on the toolbar. The Filter Process Instances window appears. If you do not specify the filter criteria for process instances, the default filter options are considered.
    3.Type the selection criteria.
    4.Click OK. All process instances that match the specified criteria are displayed.

    5. Click the Show Sub-Processes ( ) icon to display the sub-processes. The Sub-Processes pane appears.
  2. Select the required process instance and click Show Message Map () on the toolbar. Alternatively, you can right-click the process instance and select Show Message Map. The Message Map Data - View and Edit the Messagemap Data dialog box appears.
  3. Click (Edit) on the toolbar to edit the messages in the Message Map Data - View and Edit the Messagemap Data.


    Important: You can view the (Edit) on the toolbar and edit the message map data only when the process instance is in one of the above defined statuses. Also, the (Save), (Validate), (Refresh) and (Undo) appear only when you click (Edit) .

  4. Select the view in which you want to edit the messages. List View is a guided mode whereas All View is in unguided mode. Guided mode allows you to view the current messages in which changes are made. In List View, the message content is shown according to the message selected in left pane whereas, in All View, the complete message map is shown
  5. In List View, select the message you want to edit and make required changes to the message map in the Current message pane. Changes to Instance properties are not saved.
  6. Click on the toolbar to refresh the message map.
  7. Click on the toolbar to undo the changes made in the content of the Current message.
  8. In List View, select and right-click a message in the Messages pane, and do any one of the following:
    • Insert Message: Select this option to insert a message in the Current message pane content. Alternatively, to insert a new message select in the empty area in the Messages pane of the List View to add it to the message map.
    • Rename Message: Select this option to rename an existing message.
    • Delete Message: Select this option to delete an existing message.
  9. Click on the toolbar to validate the content of the Current message.
  10. Click to save the changes to the message map.


    Important: The changes to the message map will be saved only if there are no validation errors in the message map.

  11. Click (Copy Content of Current Edit Area) on the toolbar to copy the content of the Current message to the clipboard.

You have successfully edited the Message Map data of a process instance.

Related reference

Filter Process Instances Interface
Instances by Process Definition Interface